home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / telecomm / fido / pltprg05.lha / PlutPurge.doc next >
Encoding:
Text File  |  1995-01-30  |  4.5 KB  |  111 lines
  1.  
  2.             ------------------------------------------------
  3.  
  4.                                 PlutPurge
  5.  
  6.  
  7.                          30-Jan-95 Version 0.5
  8.  
  9.  
  10.                   (c) Peter Deane (3:622/401@FidoNet)
  11.  
  12.  
  13.                        Written in GFA-BASIC V3.51
  14.  
  15.             ------------------------------------------------
  16.  
  17.  
  18. Note:  Version 0.5 of this program contains two major improvements.  If
  19. a file cannot be locked exclusively first, no attempt will be made to
  20. examine or delete the file (needed for the new outbound locking scheme
  21. used in TrapDoor 1.86 and above); and the arp.library previously
  22. required in 0.3 is now NO LONGER used at all!
  23.  
  24. NB: TrapDoor 1.86 is NOT publicly available yet, don't annoy the
  25. developers and ask about it, currently TrapDoor is at version 1.85
  26. publicly.
  27.  
  28.  
  29. PlutPurge is a small utility for users of TrapToss 1.50 or higher to
  30. keep the number of files in the outbound directory down to a manageable
  31. level by deleting un-needed empty arcmail bundles.
  32.  
  33. In TT 1.23 and below, any outbound files produced were simply based on
  34. the last echomail bundle you had sent the node.  EG a node might pick up
  35. the .MO0 bundle this time, and TrapDoor will truncate the .MO0 file to
  36. zero bytes when sent.  Next time Traptoss created a bundle for that node
  37. it would see the .MO0 0-byte file in outbound, and then bump the number
  38. by 1 so that it would create a .MO1 bundle.
  39.  
  40. This led to confusion among users, normally the prefix added to echomail
  41. bundles actually MATCHED the day number.  A bundle made on a Wednesday
  42. would be called .WE-something.  So TrapToss was brought into line with
  43. other echomail tossers, and used the day name for arcmail bundles from
  44. about V1.40 onwards.
  45.  
  46. As a result, the existence of many 0-byte files became pointless.  The
  47. only time you actually ever need to keep a 0-byte file is if it was
  48. TODAY'S.  IE if a .WE3 file existed, then if mail was tossed on
  49. Wednesday, a .WE4 file would be made up.  But if mail was tossed on any
  50. other day, the 0-byte file just would play no part in determination of
  51. the name AT ALL, and (say) a .FR0 file would be made up (given that it
  52. was Friday).
  53.  
  54. So PlutPurge is just the program for you to kill off all unwanted 0-byte
  55. files, automatically.  It's particularly useful in a multi-net situation
  56. because each node you feed might accumulate half a dozen truncated
  57. arcmail bundles per pickup.
  58.  
  59. Why kill off the unwanted files?  Mainly for increased speed in scanning
  60. the outbound directory.  Many programs you run will scan the outbound
  61. (eg TrapDoor/TrapToss), and so leaving them fewer files in the outbound
  62. simply speeds things up slightly.
  63.  
  64. I find PlutPurge works best when run two or three times a day.  You
  65. don't want to run it after every session, because the time PlutScan
  66. takes to run will be longer than the increased outbound scanning time.
  67. However, run occasionally, the benefit to the system will become
  68. apparent.
  69.  
  70. PlutPurge runs by simply scanning the outbound directory (which will
  71. default to MAIL:Outbound, or you can give it on the command line), and
  72. checking ALL files therein.  If a file is 0 bytes long, then it's
  73. considered a prime candidate for deletion.  It will ONLY be left if it
  74. has the day's first two initials in the filename.  EG if the program was
  75. run on a Tuesday, then any 0-byte file containing the letters "TU"
  76. anywhere in the filename will be left.  Otherwise, bye bye file.
  77.  
  78. The absolute worst thing the program could do is cause a duplicate
  79. arcmail bundle name to be sent to the other end from deletion of a
  80. 0-byte file.  I've never seen it do that, however!  Plutpurge also CAN
  81. NOT kill data.  If any file has just 1 byte therein it will still exist
  82. after running the program.  The only thing it is permitted to kill are
  83. 0-byte files.
  84.  
  85. The command line usage details are:
  86.  
  87. PlutPurge [DirectoryName]
  88.  
  89. If [DirectoryName] is not specified, MAIL:Outbound will be used.  Use a
  90. "?" on the command line to get full details.
  91.  
  92. The program is freely distributable, but must include all parts if
  93. re-distributed.  (PlutPurge, PlutPurge.doc, PlutPurge.LST)
  94.  
  95. If you have ANY questions, need ANY help or need to contact me for ANY
  96. reason you may do so at any of these addresses:
  97.  
  98.  
  99.         Peter Deane
  100.  
  101.         FidoNet:   3:622/401        Postal: PO Box 228
  102.         GlobalNet: 54:6101/401              Swansea  NSW  2281
  103.         AmigaNet:  41:200/401               AUSTRALIA
  104.  
  105.         Internet: peter.deane@p0.f401.n622.z3.fido.zeta.org.au
  106.                   (okay, I cheated, but the gate works really well)
  107.  
  108.         Or call the BBS:   from O/S   +61-49-72-1647
  109.         (24 hrs)           from Aust  (049) 72-1647
  110.  
  111.